home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / tmail111.arc / TMAIL.DOC < prev    next >
Encoding:
Text File  |  1990-03-19  |  43.9 KB  |  1,252 lines

  1.  
  2.              ┌─────────────────────────────────────────────────┐
  3.              │  ████    ████                                   │
  4.              │  ██ ██  ██ ██                                   │
  5.              │  ██  ████  ██ ╔══╗ ╔═══╬═╦══ ╔══╗ ╔══           │
  6.              │  ██   ▀▀   ██ ╠══╣ ╚═╗ ║ ╠═  ╠═╦╝ ╚═╗           │
  7.              │  ██        ██ ╜  ╚═══╝ ╜ ╚═══╝ ╚════╝           │
  8.              │  ██     ████████ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀           │
  9.              │         ██    ▀▀                                │
  10.              │         ██                                      │
  11.              │         ████████ ╔══╗ ╔══╬═╗    ╔═╦══╗ ╔══╗ ╔══ │
  12.              │               ██ ║  ║ ╠═ ║ ║ ╔╗ ║ ╠══╣ ╠═╦╝ ╠═  │
  13.              │         ▄▄    ██ ╚══╩═╝  ╜ ╚═╝╚═╝ ╜  ╚═╝ ╚══╩══ │
  14.              │         ████████ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ │
  15.              └─────────────────────────────────────────────────┘
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             T H E  -  M A I L !
  26.  
  27.                 An automated file transfer script for TELIX
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.       The-Mail! is released to the public domain and you are granted
  41.       full licence to distribute this product, at no charge, to any
  42.       interrested party, provided that the Masters Software logo and
  43.       name remain attached to the product and it is distributed with
  44.       all files in an un-modified condition.
  45.  
  46.       The-Mail! is a SALT language application written by Masters
  47.       Software.  The-Mail! is supplied "as-is" and Masters Software
  48.       offers no Warantees regarding the function or suitability of
  49.       this product.
  50.  
  51.       Masters Software and/or associates will not be held liable or
  52.       responsible for any losses either real or anticipated which may
  53.       result from the use or abuse of this product.
  54.  
  55.       The-Mail! is not now nor will it ever be in any way compatible
  56.       with any communications programs used to communicate messages or
  57.       files between Bulletin Board Systems, nor is it compatible with
  58.       any other package which might perform a similar function to that
  59.       performed by The-Mail!.
  60.                          The-Mail! Users Guide
  61.  
  62.  
  63.           Table Of Contents
  64.               Introduction..............................1
  65.  
  66.               Files In The Package......................2
  67.               Other Software You Will Need..............2
  68.               Notes About Shareware.....................2
  69.  
  70.               Some Points about Modems..................3
  71.  
  72.               Installing The-Mail!......................4
  73.                    Floppy Disk Users....................4
  74.                    Hard Disk Users......................4
  75.                    Make a The-Mail! Phone List..........5
  76.  
  77.               Running TCONFIG...........................6
  78.                    TCONFIG Menu entries.................6
  79.                         The-Mail! Name..................6
  80.                         Full Name.......................6
  81.                         Street Address..................6
  82.                         City/Province/Pc................6
  83.                         Phone Number....................6
  84.                         Incoming tmail..................7
  85.                         Outgoing tmail..................7
  86.                         Cyclic Dial Start...............7
  87.                         Cyclic Dial Stop................7
  88.                         Abort TELIX.....................7
  89.  
  90.               Running The-Mail!.........................8
  91.                    The-Mail! Menu Selections............8
  92.                         Caller Mode During Call.........8
  93.                         Host Mode During Call...........8
  94.                         Dialing Directory...............8
  95.                         Lock Out Timed Functions........8
  96.                         Resume Timed Functions..........9
  97.                         Force Cyclic Dialing............9
  98.                         Set Start/Stop Times............9
  99.                         Quit The-Mail!..................9
  100.                         Jump to DOS.....................9
  101.                         ESC Hang-up Modem...............9
  102.  
  103.               The The-Mail! Sequence...................10
  104.                    Files To Be Sent....................11
  105.                    Received Files......................12
  106.                    Making Contact......................12
  107.  
  108.               Host Mode................................13
  109.               Existing Call Mode.......................13
  110.               Manual Dial Mode.........................13
  111.               Cyclic Dailing Mode......................14
  112.               The-Mail! and Bulletin Boards............16
  113.               Setting Up a The-Mail! Network...........17
  114.  
  115.               Calling Masters Software.................18
  116.                          The-Mail! Users Guide
  117.  
  118.  
  119.      Introduction:
  120.  
  121.      The-Mail! was created to solve a communications problem. 
  122.  
  123.      One  of  my  friends (also a business associate) was  moving  quite  a 
  124.      distance away, and we needed a means of sending confidential mail  and 
  125.      files back and forth very cheaply.  At first we thought of the popular 
  126.      networks  that exist between BBS systems, which work  wonderfully  for 
  127.      most situations, but rejected them for various reasons.  Investigating 
  128.      Shareware  and  Commercial  software  did  not  provide  an   adequate 
  129.      solution,  since each package seemed to have some shortcoming  in  the 
  130.      situation we had.
  131.  
  132.      What  we  needed was a package that would come to life late  at  night 
  133.      when  the  rates  were low, do a very  rapid  exchange  of  compressed 
  134.      archive  files and then get off line just as quickly as possible.   At 
  135.      first I wrote a TELIX script to handle just this one situation but  it 
  136.      wasn't long before we realized that it could do more. 
  137.  
  138.      The-Mail!  grew  from this to a fully time driven  private  networking 
  139.      system that uses its own phone list, incorporates an automatic  log-on 
  140.      sequence  that gives full security to your system and once contact  is 
  141.      established  it  does an automated file send and receive  during  each 
  142.      contact  (if files are available).  Thanks to the power of TELIX  SALT 
  143.      language it is still a script program!
  144.  
  145.      When you start The-Mail! it sits in "Host Mode" waiting for a call and 
  146.      will  answer the phone for you and do the appropriate exchanges  while 
  147.      waiting  for its "Cyclic Dialing" time to begin.  Once it is  time  to 
  148.      start cyclic dialing The-Mail! will call the other The-Mail! terminals 
  149.      listed  in  your  phone  list and do the file  trades  for  you.   All 
  150.      unattended and late at night - when the phone is cheapest.
  151.  
  152.      System security is assured by a log-on routine that trades a  password 
  153.      and  both  parties full names and addresses at the beginning  of  each 
  154.      exchange.   Only  another The-Mail! terminal can complete  the  log-on 
  155.      sequence.    Further  to  this  The-Mail!  only  has  access  to   two 
  156.      directories  on  your  system  - One for incoming  mail  and  one  for 
  157.      outgoing mail.  Of course since this is a one-to-one contact there  is 
  158.      no chance of someone "stealing" your files from a BBS or network!
  159.  
  160.      We  now  use  The-Mail! with all our customers and  have  a  regularly 
  161.      scheduled  "Mail  Hour".  If you wish to test The-Mail! or send  us  a 
  162.      letter  or  two,  see  the  section  later  in  this  document  titled 
  163.      "Contacting Masters Software".
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.      Copyright   Masters Software 1990.                   pg.1
  179.                          The-Mail! Users Guide
  180.  
  181.  
  182.      Files In The Package
  183.  
  184.      If  you  are  receiving The-Mail! by any means  you  should  have  the 
  185.      following files:
  186.  
  187.          TMAIL.SLC     The The-Mail! script for TELIX.
  188.          TCONFIG.SLC   The The-Mail! setup script for TELIX.
  189.          TMAIL.DOC     This instruction manual file.
  190.          README.1st    General information text file. 
  191.  
  192.  
  193.      Other Software You Will Need
  194.  
  195.      The-Mail! is a TELIX script language (SALT) program.  In order to  use 
  196.      The-Mail! you will also need the following programs:
  197.  
  198.      TELIX  (Version 3.11 or newer)
  199.          TELIX is a Communications package produced by EXIS Inc. and it  is 
  200.          distributed  as Shareware.  If you are unable to find it  on  your 
  201.          local Bulletin Boards you can contact:
  202.  
  203.          Exis inc., P.O. Box 130, West Hill Ontario, Canada  M1E  4R4 
  204.  
  205.          Phone (416) 289-4641    Fax (416) 289-4645
  206.  
  207.          Or you can get it from their support BBS at: (416) 439-8293
  208.  
  209.      PKZIP/PKUNZIP (Version 1.02 or newer)
  210.  
  211.          PkZip is a file compression utility that will reduce your  on-line 
  212.          time  by at least 1/3 and in many cases saves more than  half.   I 
  213.          highly recommend PkZip for use with The-Mail!.
  214.  
  215.          The PkZip package is also distributed as Shareware under the  file 
  216.          name of PKZ102.EXE and it is available from most Bulletin  Boards, 
  217.          or you can contact:
  218.  
  219.          PKWare inc., 7545 N. Pt. Washington Rd., Glendale Wi. 53217-3442
  220.  
  221.          Phone (414) 352-3670      Fax (414) 352-3815
  222.  
  223.          Or you can download it from their support BBS at: (414) 352-3670
  224.  
  225.      Notes About Shareware:
  226.  
  227.      Shareware  is  not free software.  Most Shareware  packages  represent 
  228.      hundreds of hours of work by highly qualified programmers who rely  on 
  229.      your registration fees to make all or part of their livings.  Both the 
  230.      above packages are very high quality and I heartily recommend that you 
  231.      pay the small fees asked.  Shareware relies on you to make it work!
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.      Copyright   Masters Software 1990.                   pg.2
  242.                          The-Mail! Users Guide
  243.  
  244.  
  245.      Some Points About Modems
  246.  
  247.  
  248.      When The-Mail! starts up it expects a few things to be true about your 
  249.      copy of TELIX and your modem:
  250.  
  251.          It  expects you to have a modem that is 100% compatible  with  the 
  252.          standard 'AT' command set.
  253.  
  254.          It  assumes  that the modem is configured  and  working  correctly 
  255.          under  the  normal TELIX terminal and that the 'modem  init.'  and 
  256.          'auto-answer' strings contain no errors.
  257.  
  258.          Your  modem  must  be sending verbal result codes  as  opposed  to 
  259.          numeric result codes.  (The ATV1 state)  If you are not sure  that 
  260.          it is type  AT  and press Enter while in the TELIX terminal screen 
  261.          -  If the modem responds with 'OK' then it should work  with  The-
  262.          Mail!.   If  the  response is '0' you will need to  add  the  'V1' 
  263.          command to your init. string in the ALT-O/Modem window.  
  264.  
  265.          The  modem must respond correctly to the ALT-H  (hang-up)  command 
  266.          from  the TELIX terminal window.  2400 baud users may have to  add 
  267.          '&C1&D1'  or '&C1&D2' to their modem Init. strings to get this  to 
  268.          work.
  269.  
  270.          In  the ALT-O/Modem part of your setup window you must have  "Drop 
  271.          DTR to hang up" active.
  272.  
  273.  
  274.      The-Mail!  issues the following commands to your modem and expects  it 
  275.      to respond correctly:
  276.  
  277.          Your TELIX dialing strings are used by The-Mail! during Cyclic  or 
  278.          Manual Dialing. 
  279.  
  280.          When  using  Host Mode during an existing  call,  The-Mail!  sends 
  281.          'ATA'  to  your modem and expects it to come off hook and  send  a 
  282.          carrier signal.
  283.  
  284.          When  in  Caller  Mode during an existing  call,  The-Mail!  sends 
  285.          'ATH1O'  to initiate the originate mode in the modem  and  expects 
  286.          the modem to respond by coming off hook and waiting for a carrier.
  287.  
  288.          When The-Mail! loads and starts running it sends the  'Auto-Answer 
  289.          String'  to the modem to set it to answer incoming calls.  If  you 
  290.          wish  to  silence the modem this string should  include  the  'M0' 
  291.          parameter.
  292.  
  293.          At  the end of each session The-Mail! resets your modem using  the 
  294.          Init.  sting from the ALT-O/Modem part of the TELIX  configuration 
  295.          window.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.      Copyright   Masters Software 1990.                   pg.3
  305.                          The-Mail! Users Guide
  306.  
  307.  
  308.      Installing The-Mail!
  309.  
  310.      The-Mail! is very easy to install and requires only that you make  two 
  311.      directories  and  run  a  simple  configuration  program.   The  setup 
  312.      procedure  is below and the Configuration program is described in  the 
  313.      next section.
  314.  
  315.  
  316.  
  317.  
  318.  
  319.      Floppy Disk Users.
  320.          Format a fresh disk and make the following directories on it:
  321.  
  322.               \MAILIN
  323.               \MAILOUT
  324.  
  325.          Copy  the  files TMAIL.SLC and TCONFIG.SLC to your  TELIX  program 
  326.          disk.
  327.  
  328.  
  329.  
  330.  
  331.      Hard Disk Users.
  332.  
  333.          From your TELIX directory make the two directories:
  334.  
  335.              C:\TELIX\MAILIN
  336.              C:\TELIX\MAILOUT 
  337.  
  338.          If you don't already have a scripts directory create one as:
  339.  
  340.               C:\TELIX\SCRIPTS
  341.  
  342.          Copy   the  files  TMAIL.SLC  and  TCONFIG.SLC  to  your   scripts 
  343.          directory.
  344.  
  345.          Under  your  ALT-O  menu  select "Files and  Paths"  and  set  the   
  346.          "Scripts Directory" to:
  347.  
  348.               C:\TELIX\SCRIPTS
  349.  
  350.  
  351.  
  352.      Actually you can name the directories anything you want to name  them, 
  353.      but  for the balance of this manual I will assume that you  have  used 
  354.      the names indicated above.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.      Copyright   Masters Software 1990.                   pg.4
  368.                          The-Mail! Users Guide
  369.  
  370.  
  371.      Installing The-Mail!  (continued)
  372.      Make a The-Mail! Phone List
  373.  
  374.          From  the TELIX terminal screen type ALT-D.  This  will  bring  up    
  375.          your dialer window.
  376.  
  377.          Type  O for Other functions which will change the menu bar at  the 
  378.          bottom of the screen.
  379.  
  380.          Type C for Create.  This will bring up a window that will ask  you 
  381.          for the name of the blank phone list.
  382.  
  383.          Type in TMAIL.FON and press Enter.  This will create a  new  phone 
  384.          list for you to use with your The-Mail! contacts.  
  385.  
  386.               NOTE: You must use   TMAIL.FON   for this to work.
  387.  
  388.          Once  you have The-Mail! on screen you will be able to  enter  the 
  389.          new  phone  list  and put all the required  information  into  it.  
  390.          (This comes a little later in the manual.)
  391.  
  392.  
  393.  
  394.      Please  note that you must make this phone list for The-Mail!  to  run 
  395.      and that you can only make an un-attended The-Mail! contact from names 
  396.      on this list and while actually running The-Mail!.  It is not possible 
  397.      to  call a The-Mail! terminal from outside The-Mail! and complete  the 
  398.      required sequences!
  399.  
  400.  
  401.      This  completes  the basic installation.  Now it is time  to  run  the 
  402.      configuration script,  TCONFIG.SLC
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.      Copyright   Masters Software 1990.                   pg.5
  431.                          The-Mail! Users Guide
  432.  
  433.  
  434.      Running TCONFIG.
  435.  
  436.  
  437.      TCONFIG is the The-Mail! configuration program and is the next step in 
  438.      setting up.  To start TCONFIG :
  439.  
  440.          From the TELIX terminal screen type ALT-G.  This will bring up the 
  441.          script execution window.
  442.  
  443.          Type TCONFIG and press Enter.  This will start TCONFIG running and 
  444.          it will present you with its menu. 
  445.  
  446.      Now that you have the The-Mail! Configuration menu on screen, this  is 
  447.      the time to do all the setup needed to make it work.  All you need  to 
  448.      do is type the letter (A through J) at the beginning of each line  and 
  449.      enter  the information appropriate to the area.  You will be  prompted 
  450.      as  to  what  is  expected and the  next  section  is  a  line-by-line 
  451.      description of each entry.
  452.  
  453.  
  454.      TCONFIG Menu Entries
  455.  
  456.          A.  The-Mail! Name
  457.  
  458.          This  is the name of the file that the The-Mail! you contact  will 
  459.          look for when sending you a file, or create when receiving a  file 
  460.          from  you.  This can be 3 to 8 characters in length and  must  not 
  461.          contain  any characters that DOS will not recognize as part  of  a 
  462.          filename.  
  463.  
  464.          B.  Full Name
  465.  
  466.          Enter your full name (or business name) here.  This information is 
  467.          transmitted  to  the  other The-Mail! at  the  beginning  of  each 
  468.          contact so be sure it is correct, if you are expecting a reply.
  469.  
  470.          C.  Street Address
  471.  
  472.          This  should  contain  your street number,  street  name  and  any 
  473.          apartment or unit numbers that are appropriate.  This  information 
  474.          is also sent during each contact.
  475.  
  476.          D.  City/Prov/Pc  (or City/State/Zip for U.S.A.)
  477.  
  478.          This  completes your address and is sent to the other end on  each 
  479.          contact.
  480.  
  481.          E.  Phone Number
  482.  
  483.          Enter  your  phone  number  here,  include  the  area  code   when 
  484.          appropriate.   This can be either your voice phone number or  your 
  485.          computer  number  for return The-Mail! contacts.   Which  you  use 
  486.          would depend on the arrangements made in your own The-Mail! net.
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.      Copyright   Masters Software 1990.                   pg.6
  494.                          The-Mail! Users Guide
  495.  
  496.  
  497.          F.  Incoming The-Mail!
  498.  
  499.          This is the full path and directory name for files you receive via 
  500.          The-Mail!.   If  you are following our example  installations  you 
  501.          would  put  C:\TELIX\MAILIN\  here if you were  on  a  hard  disk.  
  502.          Floppy users would make an entry like B:\MAILIN\ (if the mail disk 
  503.          was in B:)
  504.  
  505.          G.  Outgoing The-Mail!
  506.  
  507.          Enter  the full path and directory name here, for files  that  you 
  508.          receive   via   The-Mail!.    Hard   disk   users   would    enter 
  509.          C:\TELIX\MAILOUT\ or Floppy users could enter B:\MAILOUT\
  510.  
  511.          H.  Cyclic Dial Start
  512.  
  513.          This  is  a time in hours and minutes when you want  The-Mail!  to 
  514.          begin Cyclic Dialing out to other The-Mail! contacts on your list.  
  515.          Make the entry in Military time as HH:MM  for example 8:15p.m.  is 
  516.          20:15 and 7:03am is 07:03.  (don't forget the leading 0s)
  517.  
  518.          I.  Cyclic Dial Stop
  519.  
  520.          This  is  the  time to stop Cyclic dialing.   Make  the  entry  as 
  521.          described  above.  Please note that if this time is  earlier  than 
  522.          the  Start  time Cyclic dialing will begin at the Start  Time  and 
  523.          continue until the Stop Time... the next day.
  524.  
  525.          J.  Abort TELIX
  526.  
  527.          Enter  the time at which you want Telix to exit to DOS, using  the 
  528.          same HH:MM style as above.  Setting this to 00:00 will prevent the 
  529.          Exit to DOS altogether.  Usually this would be 00:00 except in the 
  530.          case  where  The-Mail!  is used with a BBS  as  explained  in  the 
  531.          section  titled  "The-Mail!  and Bulletin Boards"  later  in  this 
  532.          manual.
  533.  
  534.      If  you are just beginning with The-Mail! you will have to go to  each 
  535.      entry  in turn and fill in the information.  Once you have it  all  in 
  536.      the  only time you should have to run TCONFIG again is to change  your 
  537.      Identification or your default dialing hours.  (If you want to  change 
  538.      your dialing hours for one session only you can do this from the  The-
  539.      Mail! menu in the main program.)
  540.  
  541.      Note:  To completely defeat the cyclic Dialing make the stop time  the 
  542.      same as the start time.
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.      Copyright   Masters Software 1990.                   pg.7
  557.                          The-Mail! Users Guide
  558.  
  559.  
  560.      Running The-Mail!
  561.  
  562.      The  main  The-Mail!  script  will not run  properly  until  you  have 
  563.      completed all entries in the TCONFIG menu.  If you have not done  this 
  564.      you  should  do  it now if you want to work with the  manual  and  the 
  565.      screen together.
  566.  
  567.  
  568.      The startup procedure is this:
  569.  
  570.          From the TELIX terminal screen type ALT-G.  This will bring up the 
  571.          script execution window.
  572.  
  573.          Type TMAIL  and press Enter.
  574.  
  575.          You should get the message "Setting Up" followed by the  The-Mail! 
  576.          Menu.
  577.  
  578.      You  should  now have The-Mail! running, and it will be in  Host  mode 
  579.      ready to take an incoming call.  From here you can literally walk away 
  580.      from  it and let it run unattended, but for learning purposes we  will 
  581.      go through each function and mode in turn.
  582.  
  583.  
  584.  
  585.      The-Mail! Menu Selections
  586.  
  587.          (C)aller Mode During Call.
  588.  
  589.          This function and its compliment "Host Mode During Call" are  used 
  590.          to  pick  up the line with the modem and connect  to  a  The-Mail! 
  591.          system  at the other end of a call which is already  in  progress.  
  592.          This  is explained more fully under "Existing Call Mode" later  in 
  593.          this manual.
  594.  
  595.          (H)ost Mode During Call
  596.  
  597.          This  is  the  compliment  of "Caller Mode  During  Call"  and  is 
  598.          explained  more fully in the section titled "Existing  Call  Mode" 
  599.          later in this manual.
  600.  
  601.          (D)ialing directory
  602.  
  603.          This menu selection is used to bring up the TMAIL.FON dialing list 
  604.          to allow you to make manually selected The-Mail! calls or to  edit 
  605.          the  numbers  and names in your list.  It is not time  driven  and 
  606.          marking entries will not alter the Cyclic Dialing activity of The-
  607.          Mail!.   See  "Manual Dial Mode" and "Cyclic Dial" later  in  this 
  608.          manual.
  609.  
  610.          (L)ock Out Timed Functions
  611.  
  612.          Use this function to completely disable Cyclic Dial during a  The-
  613.          Mail! session. 
  614.  
  615.  
  616.  
  617.  
  618.  
  619.      Copyright   Masters Software 1990.                   pg.8
  620.                          The-Mail! Users Guide
  621.  
  622.  
  623.          (R)esume Timed Functions
  624.  
  625.          After using the H, C or D selections from the menu, cyclic dialing 
  626.          will be locked out.  Press R to release it back to normal activity.
  627.  
  628.          (F)orce Cyclic Dialing 
  629.  
  630.          Using this selection will change the Cyclic Dialing start time  to 
  631.          be right now.  You would use this to begin a dialing session early 
  632.          or outside normal dial-out hours set in TCONFIG.
  633.  
  634.        
  635.          (S)et Start/Stop Times
  636.  
  637.          This  allows  you  to change the start and stop  time  for  Cyclic 
  638.          dialing during the current session only (the TMAIL.CFG file is not 
  639.          changed).  See "Cyclic Dialing Mode" for a full explanation.
  640.  
  641.          (Q)uit The-Mail!
  642.  
  643.          This menu selection will abort The-Mail! altogether and leave  you 
  644.          at the TELIX terminal window.  The modem initialization string  is 
  645.          sent so that the The-Mail! parameters are re-set.
  646.  
  647.          (J)ump to DOS
  648.            
  649.          This function allows you to shell out to DOS while at the menu  of 
  650.          The-Mail!  To return to the script type EXIT at the DOS prompt and 
  651.          press Enter.
  652.  
  653.          (ESC) Hang-up Modem
  654.  
  655.          Pressing  ESC will force a "Hang-up" command to be issued  to  the 
  656.          modem.  This key is active in all modes, at all times.
  657.  
  658.  
  659.      Each  of these menu selections will be explained more fully as we  get 
  660.      to the individual modes of The-Mail! a bit later in this manual.
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.      Copyright   Masters Software 1990.                   pg.9
  684.                          The-Mail! Users Guide
  685.  
  686.  
  687.      The The-Mail! Sequence
  688.  
  689.      The-Mail!  is designed to transfer .ZIP archive  files  automatically, 
  690.      between two running The-Mail! scripts, and can do it in an  unattended 
  691.      fashion  if  you  so  desire.   Transfers  are   accomplished  by  the 
  692.      following sequence, which takes place during each contact:
  693.  
  694.      Log-on.
  695.          Your  The-Mail! name and your full name, address and phone  number 
  696.          as set up in TCONFIG are traded for the same information from  the 
  697.          other The-Mail! terminal.
  698.  
  699.      Sending.
  700.          One  file  can  be sent during each The-Mail!  contact.   This  is 
  701.          explained  in the section "Files To Be Sent".  Sending  is  always 
  702.          via XMODEM protocol.
  703.  
  704.      Receiving.
  705.          The-Mail!  will go into an XMODEM receive condition and  wait  for 
  706.          the other end to either send one file or to cancel this portion of 
  707.          the transfer.  This is explained below in "Received Files".
  708.  
  709.      Logging.  
  710.          The-Mail! keeps a detailed log to let you know who your  The-Mail! 
  711.          has  talked to and what happened during the contacts.  The log  is 
  712.          in TMAIL.LOG in your TELIX directory.
  713.       
  714.      Disconnect.  
  715.          At  the end of all the above both The-Mail! packages hang  up  and 
  716.          the contact is completed.
  717.  
  718.      This transfer sequence allows no intervention by the operators of  the 
  719.      two  communicating  The-Mail! terminals and can even  be  accomplished 
  720.      late  at  night by a process of Cyclic Dialing as explained  later  in 
  721.      this  manual.  If you wish to do the call selection manually  you  can 
  722.      use  the  Manual Dial Mode to pick which The-Mail! calls you  want  to 
  723.      make immediately.
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.      Copyright   Masters Software 1990.                   pg.10
  747.                          The-Mail! Users Guide
  748.  
  749.  
  750.      Files To Be Sent
  751.  
  752.      To  send a file to another user, what you need to do is put the  right 
  753.      files, archived with PKZIP, with the right names in the Outgoing  The-
  754.      Mail! directory.
  755.  
  756.      When a contact is made one of two files can be sent:
  757.  
  758.      An explicit file.
  759.          If you wish to send a file explicitly to one caller it must be  in 
  760.          your  Outgoing The-Mail! directory with the The-Mail! name of  the 
  761.          party  you are sending it to as its first name, and the  extension 
  762.          '.ZIP'. 
  763.  
  764.          e.g.  Our The-Mail! name is MASTERS.  Thus a file for us would  be 
  765.          named MASTERS.ZIP  and would be placed in your Outbound  The-Mail! 
  766.          directory.
  767.  
  768.  
  769.      ALL.ZIP as an alternate.
  770.          This file (if it exists) will be sent to any caller when The-Mail! 
  771.          cannot  find a file that bears their The-Mail! name.  The  archive 
  772.          file  ALL.ZIP  must  be  created with PKZIP  and  placed  in  your 
  773.          Outgoing The-Mail! directory. 
  774.  
  775.  
  776.      Failing both of the above, a cancel sequence is sent.
  777.  
  778.      Text  files sent as part of an archive should be in plain  ASCII  with 
  779.      line  feeds  included,  to ensure that  they  will  exchange  properly 
  780.      between  word-processing packages.  (If a text file displays  properly 
  781.      with the DOS  'TYPE' command it should be fine.)
  782.  
  783.      There  are no restrictions on the contents of the archive  files  that 
  784.      are transferred by The-Mail! but since only one file is sent per  call 
  785.      you must use PKZIP to create an archive file.   This will also  reduce 
  786.      sending  time when only one file is sent since PKZIP really shrinks  a 
  787.      file for you.
  788.  
  789.      Please  note: Depending on your network agreements it is  possible  to 
  790.      use  any  file  compression  system, or none at  all  -but-  the  file 
  791.      extension must be '.ZIP' or The-Mail! will not send it.
  792.  
  793.      Please  note:   EXPLICIT FILES ARE ERASED AFTER  SENDING,  to  prevent 
  794.      double sends!  Do not place the only copy you have of any file in  the 
  795.      Outgoing The-Mail! directory!
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.      Copyright   Masters Software 1990.                   pg.11
  810.                          The-Mail! Users Guide
  811.  
  812.  
  813.      Received Files
  814.  
  815.      When  a  file  is sent to you from another The-Mail!  terminal  it  is 
  816.      placed  in your Incoming TMAIL directory under the other parties  The-
  817.      Mail!  name with the extension .ZIP. This helps you keep track of  who 
  818.      is sending you what.
  819.  
  820.      e.g.  A  file  received from us would be in  your  Incoming  The-Mail! 
  821.      directory under the name MASTERS.ZIP.  
  822.  
  823.      Should  two files of the same name come in the second file  will  have 
  824.      the extension .ZI0, the third will be .ZI1 and so on.  The-Mail!  will 
  825.      never over-write a file!
  826.  
  827.      Since the file you receive is an archive you will have to use  PKUNZIP 
  828.      to  extract the actual file(s) that are in the archive.  PKUNZIP  will 
  829.      recreate  the  original  files under the same names they  had  on  the 
  830.      sending The-Mail! system and the archive can be erased once the  files 
  831.      are recovered from it.
  832.  
  833.      It is a good idea to avoid confusion by moving the files elsewhere  on 
  834.      your  system and to keep the Incoming The-Mail! directory as empty  as 
  835.      possible. 
  836.  
  837.  
  838.      Please  note:  The archiving scheme may be changed by  decisions  made 
  839.      when setting up the network you are part of but the file extension  of 
  840.      received  files  will be .ZIP regardless of your  decisions.   In  the 
  841.      interests  of  universality,  I strongly favour  the  PKZIP  archiving 
  842.      package.
  843.  
  844.  
  845.      Making Contact
  846.  
  847.      The  normal  mode of operation for The-Mail! is the Cyclic  Dial  mode 
  848.      which will run un-attended and call the first 50 numbers in your phone 
  849.      list in a cycle attempting to make as many contacts as possible.
  850.  
  851.      Please  Note: Do not put any numbers you don't want to cyclic dial  in 
  852.      the first 50 listings of your phone book.  Use the manual number entry 
  853.      function  of the Dialing Directory, or keep the numbers below  #50  on 
  854.      your dialing list.
  855.  
  856.      If you wish to send the files immediately use the Manual Dial Mode  to 
  857.      select  the  calls to make from the The-Mail! dialing window.   We  do 
  858.      most  of  our  calling out this way and use the  Manual  number  entry 
  859.      selection from the dialing menu for long distance calls.
  860.  
  861.      If  you  have a network schedule you need do nothing except  start  up 
  862.      The-Mail! and let it run un-attended in the Cyclic Dial mode until the 
  863.      end of your agreed time.
  864.  
  865.      You can even do the transfers "call in progress" if you like.  See the 
  866.      section on "Existing Call Mode" for details.
  867.  
  868.  
  869.  
  870.  
  871.  
  872.      Copyright   Masters Software 1990.                   pg.12
  873.                          The-Mail! Users Guide
  874.  
  875.  
  876.      Host Mode
  877.  
  878.      The  The-Mail! Host Mode is active at any time that the  The-Mail!  is 
  879.      not otherwise occupied.  The-Mail! will answer the phone when it rings 
  880.      and begin the log-on sequence.  If the call is from another  The-Mail! 
  881.      terminal the full sequence will begin and files will be transferred if 
  882.      available.   At the end of the contact (successful or otherwise)  The-
  883.      Mail! falls back into the Host Mode and is ready for another call.
  884.  
  885.      If  you  get a call from a non-The-Mail! user they will  get  the  on-
  886.      screen message "This is not a BBS!", followed by a disconnect.
  887.  
  888.  
  889.      Existing Call Mode
  890.  
  891.      When  operating  The-Mail!  on a voice line that  is  shared  by  your 
  892.      computer  you  can  get  The-Mail! to  connect  to  another  The-Mail! 
  893.      terminal without breaking the connection of a call in progress.   This 
  894.      is  provided for situations where you don't want The-Mail!  to  answer 
  895.      every call, and also saves the "3 minute minimum" from being  repeated 
  896.      by  the  phone company as it would be when the connection  had  to  be 
  897.      broken and the call placed again to get the computers to connect.
  898.  
  899.      To get The-Mail! to connect during an existing call, one party has  to 
  900.      select  "Host  Mode During Existing Call" and the  other  must  select 
  901.      "Caller  Mode During Existing Call".  Once these selections have  been 
  902.      made  and the computer's tones can be heard on the line  both  parties 
  903.      can  hang  up their voice receivers and the computers will  then  take 
  904.      over and go through a The-Mail! sequence.
  905.  
  906.      The  party selecting 'Caller Mode' will be asked for the Baud Rate  so 
  907.      that  a connect can be assured with any speed Host system.  Enter  the 
  908.      fastest  speed that the Host terminal can accept if it is slower  than 
  909.      your  fastest speed.  Pressing Enter or ESCape on a blank  entry  will 
  910.      default to your fastest speed.
  911.  
  912.      Please note that the modem connection is always broken at the end of a 
  913.      The-Mail!  sequence, so it is best to do the transfers at the  end  of 
  914.      the  voice  part  of the call.  Some modems  include  a  switch  which 
  915.      automatically  disconnects  the handset for you, if you  have  such  a 
  916.      modem you can continue the conversation, if needed.
  917.  
  918.  
  919.      Manual Dial Mode
  920.  
  921.      When you select "Dialing Directory" from the main menu you are putting 
  922.      The-Mail! in the Manual Dial Mode.  This condition allows you to  pick 
  923.      and choose who you call and the calls are done immediately in a  cycle 
  924.      just like dialing out in the TELIX terminal mode.  
  925.  
  926.      Numbers  that you do not wish to dial during cyclic  dialing  activity 
  927.      should  not be in the first 50 listings in your phone book.   Use  the 
  928.      Manual number entry function of the dialing window for numbers you  do 
  929.      not wish to 'cyclic dial'.
  930.  
  931.  
  932.  
  933.  
  934.  
  935.      Copyright   Masters Software 1990.                   pg.13
  936.                          The-Mail! Users Guide
  937.  
  938.  
  939.      Please  note that any names selected while in the Dialing window  will 
  940.      not change the behavior of the Cyclic Dialing routine, which will call 
  941.      up  to  50 contiguous names on your list. (The next  section  explains 
  942.      this a little better.)
  943.  
  944.      If you have a number of calls to make while in Manual Dial Mode select 
  945.      them  with the cursor keys and the space bar (just like while  in  the 
  946.      Dialing  window of the normal TELIX terminal).  When you  press  enter 
  947.      The-Mail!  will  begin  dialing out to the names  you  have  selected.  
  948.      While  the manual dialing cycle is trying the selected names  on  your 
  949.      list  the  Host  Mode is not active and The-Mail!  cannot  answer  the 
  950.      phone, so it is best to use the Cyclic Dialing whenever possible.
  951.  
  952.  
  953.      Cyclic Dialing Mode
  954.  
  955.      This  is the time driven function of The-Mail!.  When the DOS time  of 
  956.      day clock reaches the Cyclic Dialing Start Time, or if you start  The-
  957.      Mail! within the range of time between the Start and Stop times,  The-
  958.      Mail!  will begin dialing out to the first 50 names on your  The-Mail! 
  959.      list and trying to complete as many file transfers as possible.
  960.  
  961.      Dialing begins with entry number 1 on your list and continues down the 
  962.      list  until  it  reaches  the end of the  list,  or  entry  number  50 
  963.      whichever comes first.  The-Mail! keeps track of who has been  reached 
  964.      and who hasn't.  It will not call the same number from the list  twice 
  965.      during the same day or session if a carrier was detected (whether  the 
  966.      contact is successful or not).  Thus as each The-Mail! terminal in the 
  967.      sequence  is  contacted  it is flagged out of  the  cycle  to  prevent 
  968.      unnecessary repeat calls.  Busy or No Answer numbers will be re-dialed 
  969.      in a loop until a carrier is detected.
  970.  
  971.      Please  note  that  the Cyclic Dialing cannot keep track  of  who  has 
  972.      called  in and it is possible that it may call out to someone who  has 
  973.      already  called  you.  This will be a very brief contact  since  there 
  974.      will be no files to transfer (less than 30 seconds).
  975.  
  976.      Since only the first 50 callers on your list are called during  Cyclic 
  977.      Dialing  you are advised to keep any names you do not wish to call  as 
  978.      part of this cycle above #50, or to use the Manual entry selection  of 
  979.      the dialing menu if you have less than 50 names on your list.   (Don't 
  980.      insert  a  bunch  of blank lines as this will  result  in  unnecessary 
  981.      delays in the cyclic activity.)  
  982.  
  983.      Cyclic Dialing calls are launched according to the Dial Pause time you 
  984.      set in the Modem and Dialing screen of TELIX or on 30 second intervals 
  985.      whichever is greater, and between calls The-Mail! falls into the  Host 
  986.      Mode so that another The-Mail! terminal can call in.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.      Copyright   Masters Software 1990.                   pg.14
  999.                          The-Mail! Users Guide
  1000.  
  1001.  
  1002.      This dialing routine will continue until the Cyclic Dialing Stop  Time 
  1003.      you  have  set using TCONFIG.  At this time it will sit in  Host  Mode 
  1004.      waiting for calls, or the Exit Telix time.  (See the section on  "The-
  1005.      Mail! and Bulletin Boards" for more details).
  1006.  
  1007.      It  is also possible to force the Cyclic Dial to begin immediately  by 
  1008.      pressing  F  to  select Force Cyclic Dialing  Now.   This  temporarily 
  1009.      changes the Dial Start Time and Dialing will begin immediately.
  1010.  
  1011.      Should  you  not  want the system to Cyclic Dial at  all  during  this 
  1012.      session you can lock it out using the "Lock Out Dialing" function from 
  1013.      the  menu.  "Resume Normal Dialing" will re-enable the Cyclic  Dialing 
  1014.      mode with the times set in TCONFIG.  
  1015.  
  1016.      Please  Note  that the "Host Mode during call",  "Caller  mode  during 
  1017.      call"  and  "Manual" modes will lock out the  Cyclic  Dialing  feature 
  1018.      which  must be re-enabled with the "Resume Timed Functions"  function.
  1019.      Failing to re-enable cyclic dial will result in no cyclic calls  being 
  1020.      made.
  1021.  
  1022.      If  you  would  like to change the Start and Stop times  for  a  given 
  1023.      session  select "Set Dialing Start/Stop Times" from the menu  and  you 
  1024.      will  be  asked to enter the new times.  Use the same  HH:MM  military 
  1025.      time format that you used in TCONFIG where 8:30p.m. is 20:30 and  7:05 
  1026.      am is 07:05.
  1027.  
  1028.      Please  note  that if the Stop Time is earlier than  the  Start  Time, 
  1029.      Cyclic  Dialing will begin when appropriate and continue to  the  Stop 
  1030.      Time...  the  next day.  This allows you to enter time  settings  that 
  1031.      span midnight and still have proper dialing occur.   
  1032.  
  1033.      If  you do not want the system to ever Cyclic Dial, set the Start  and 
  1034.      Stop times to both be 00:00 in TCONFIG.
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.      Copyright   Masters Software 1990.                   pg.15
  1062.                          The-Mail! Users Guide
  1063.  
  1064.  
  1065.      The-Mail! and Bulletin Boards
  1066.  
  1067.      In cases where the The-Mail! user also has a bulletin board program it 
  1068.      is  possible to use The-Mail! as an Event from the BBS  system.   This 
  1069.      provides full-automatic operation.
  1070.  
  1071.      The procedure is this...
  1072.  
  1073.          Set  a  BBS  event to SHELL to TELIX using  the  command  line  as   
  1074.          C:\TELIX\TELIX sTMAIL   <-- Note the 's'
  1075.  
  1076.          Set  the Cyclic Dial Start time to coincide with the time set  for 
  1077.          the BBS event.
  1078.  
  1079.          Set the Cyclic Dial Stop time to the time when you wish  The-Mail! 
  1080.          to stop trying to call out.
  1081.  
  1082.          Set  the Exit Telix time for the time when you want the  The-Mail! 
  1083.          event to end.  (for 00:00 use 23:59 since 00:00 is used to prevent 
  1084.          the exit from happening)
  1085.  
  1086.          Place  the command SET TELIX=C:\TELIX in your  AUTOEXEC.BAT  file.  
  1087.          (Substitute your TELIX directory name for C:\TELIX if necessary.)
  1088.  
  1089.          Reset  your computer to ensure that the SET command is  read  into 
  1090.          your DOS environment.
  1091.  
  1092.  
  1093.      With this arrangement TELIX will be started by your BBS at the desired 
  1094.      time and will in turn start The-Mail!.   At the end of the Cyclic Dial 
  1095.      time  The-Mail!  will  sit in Host mode taking  calls  and  will  exit 
  1096.      completely  back to DOS at the time set for Exit Telix in TCONFIG  and 
  1097.      the BBS will take over again.
  1098.  
  1099.      Please  note that you cannot have the Exit TELIX time set to 00:00  in 
  1100.      TCONFIG  or you will be left at the The-Mail! menu screen,  until  you 
  1101.      manually exit TELIX.  This of course will have your BBS off line until 
  1102.      you do. 
  1103.  
  1104.      Also note that The-Mail! will not exit during a file transfer, and the 
  1105.      Exit  Telix time will be delayed if a sequence goes past the time  you 
  1106.      set up... but it will exit.
  1107.  
  1108.  
  1109.      If  it  is more desirable to SPAWN from your BBS the  following  batch 
  1110.      file can be used and an event in the BBS set to call it:
  1111.  
  1112.               C:
  1113.               CD \TELIX
  1114.               TELIX stmail
  1115.               BBS.BAT              <---- substitute the name of your BBS
  1116.                                          batch file here to ensure a full
  1117.                                          BBS restart.
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.      Copyright   Masters Software 1990.                   pg.16
  1125.                          The-Mail! Users Guide
  1126.  
  1127.  
  1128.      Setting Up a The-Mail! Network
  1129.  
  1130.      Please  note:   TMAIL  is  not now nor will it  ever  be  in  any  way 
  1131.      compatible with any other communications network or program. So please 
  1132.      don't  try  calling your local BBS and getting Echo or Net  mail  with 
  1133.      this package!
  1134.  
  1135.  
  1136.      The-Mail!  can  be  used almost anyplace that  public  access  is  not 
  1137.      needed,  and files can contain almost anything you need  to  transfer.  
  1138.      Letters  and memos can be sent as easily as a data file or  a  program 
  1139.      file (try that with a FAX!).  
  1140.  
  1141.  
  1142.      For  those who wish to set up The-Mail! networks it is necessary  that 
  1143.      each  "point"  in the network must have a working copy  of  The-Mail!.  
  1144.      And  there are some agreements that must be reached amongst  users  of 
  1145.      the Net:
  1146.  
  1147.          First  it is necessary to decide a schedule so that each  user  of 
  1148.          the  net knows when all other users will be on-line for  The-Mail! 
  1149.          calls.  This is best established by group consensus.
  1150.  
  1151.  
  1152.          Second it is necessary that each user know the phone number of the 
  1153.          others in the net.  This is needed information if you are going to 
  1154.          call each other with mail and file transfers.
  1155.  
  1156.  
  1157.          Third  and  most important it is necessary to know  the  The-Mail! 
  1158.          name  of  each user you intend to call.  The-Mail! will  look  for 
  1159.          files with the other party's The-Mail! name and the extension .ZIP 
  1160.          in  your  MAILOUT directory when a contact is made, you  need  the 
  1161.          name  to know what to name the file.  (e.g. a file for us will  be 
  1162.          named MASTERS.ZIP)
  1163.  
  1164.      For  businesses that would like to use The-Mail! with their  customers 
  1165.      and employees as we do it will be necessary to publish your  The-Mail! 
  1166.      Name and the phone number, as well as the maximum Baud Rate to call at 
  1167.      to each of those who are to have access to your network.
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.      Copyright   Masters Software 1990.                   pg.17
  1188.                          The-Mail! Users Guide
  1189.  
  1190.  
  1191.      Calling Masters Software
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.      If  you would like to call and try out The-Mail! with us we  would  be 
  1198.      pleased to hear from you.  Perhaps you would like to drop us a  little 
  1199.      note and let us know what you think of The-Mail!.  
  1200.  
  1201.  
  1202.      Transfers to us must be archived with PKZIP and any text files in  the 
  1203.      archive should be in plain ASCII with line feeds included. 
  1204.  
  1205.  
  1206.      Our The-Mail! name is  MASTERS  and the phone number is  416-688-1509.  
  1207.  
  1208.                  --->     Please call at 1200 baud.  <---
  1209.  
  1210.      Our The-Mail! will be on-line week-nights from 22:00 to 23:30 our time 
  1211.      and  we  Cyclic Dial to send local messages between 22:00  and  22:30.  
  1212.      Since our line is used for voice outside these hours please call using 
  1213.      The-Mail!  only during this time span.  Contacts at special times  can 
  1214.      be arranged for business or testing related transfers by calling us on 
  1215.      voice during office hours.
  1216.  
  1217.  
  1218.      If your message needs a reply you can pick it up from us, just give us 
  1219.      a day or two to answer your messages then call us back.
  1220.  
  1221.  
  1222.  
  1223.              We hope you enjoy The-Mail! and find it very useful.
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.      Copyright   Masters Software 1990.                   pg.18
  1251. @
  1252.